home *** CD-ROM | disk | FTP | other *** search
/ MacHack 2000 / MacHack 2000.toast / pc / The Hacks / Finders Peekers / Read Me - FSM Client next >
Text File  |  2000-06-23  |  3KB  |  72 lines
  1. File System Client Framework
  2. ----------------------------
  3.  
  4. FS Code and this ReadMe by Thomas Tempelmann (fsm@tempel.org)
  5. Resource scanning, CMM and supporting code by Florian Dejako (fdj@elgato.com)
  6.  
  7. Written at MacHack #15, June 22-24, 2000
  8.  
  9.  
  10. Purpose
  11. -------
  12.  
  13. The main code is essentially a framework for writing read-only
  14. file systems. It was derived from the freeware Joliet File System,
  15. available at http://www.tempel.org/joliet/
  16. All ISO/Joliet code has been stripped out and been replaced by
  17. a simplified module that is all you have to modify when you
  18. have some source of tree-like data to display through a file
  19. system.
  20.  
  21. Programming information
  22. -----------------------
  23.  
  24. The File System project is "FSM Client.mcp". It was developed under
  25. CW Pro 5.3.
  26. The project contains three samples, all their differences are
  27. found in the files "FS API.cp", FS API 2.cp" and "FS API 3.cp".
  28. The targets are, respetively, "App", "App 2" and "App 3", which
  29. all compile into applications: if you launch them, the file
  30. system is installed, when quitting, the FS will be removed again,
  31. which is very helpful in the development phase.
  32. However, be aware that you can not use high-level debuggers,
  33. like CodeWarrior's, but only low-level, like MacsBug or the dcon
  34. output console.
  35.  
  36. There's also examples on how to make a INIT and a loadable code-rsrc
  37. (see "CODE rsrc" and "Loader App") in the various targets.
  38.  
  39. So, have a look at "FS API.cp" in order to see how to provide
  40. items for a volume. It will only show one, invariable, file in the
  41. root dir to keep it simply.
  42.  
  43. Next, check out the "App 3" target, which creates some dynamic content,
  44. and last the "App 2", which shows how to build deeper folders.
  45.  
  46. Running the sample apps
  47. -----------------------
  48.  
  49. After launching "App" and "App 3", you also need to run
  50. "Disk Driver mounting", which will install a pseudo drive that will
  51. then call PBMountVol in order to allow the File System to mount
  52. its volume.
  53.  
  54. To use "App 2", you must launch it first, then launch
  55. "Disk Driver no mount", which install a drive (with fixed drvNum 64),
  56. and last you need to drop some file with resources onto "ResFS Support",
  57. which will then scan the resources of that file, will build a table,
  58. then mount the drive #64, with passing the table to the file system,
  59. which will then show the resource items as a directory structure.
  60.  
  61. Final words
  62. -----------
  63.  
  64. The code was hacked to together in a stressful but exciting weekend
  65. at MacHack (http://www.machack.com), and has not been polished too
  66. well. There's still some construction areas left, and if you are
  67. serious about using this code, you may contact the author of the
  68. FS (Thomas Tempelmann) to get some help or updated versions of this
  69. code.
  70.  
  71. Enjoy!
  72.